home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / fbr153.arc / FBR153.DOC < prev    next >
Encoding:
Text File  |  1986-05-21  |  14.4 KB  |  435 lines
  1. -
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          FBR - File Backup / Restore
  28.                                  Version  1.5
  29.                                  May 21, 1986
  30.  
  31.                      (c) Copyright Vernon D. Buerg 1986
  32.  
  33. -
  34.  
  35. FBR - File Backup / Restore
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                 Notice
  46.                                 ------
  47.  
  48.         This is a development test release of FBR. Use these
  49.         programs at your own risk. Although they have been
  50.         extensively tested, I take no responsiblity for any
  51.         losses.
  52.  
  53.  
  54.  
  55.                              NOT PUBLIC DOMAIN
  56.                              -----------------
  57.  
  58.         This document and the FBR programs are the personal property
  59.         of:
  60.  
  61.                         Vernon D. Buerg
  62.                         456 Lakeshire Drive
  63.                         Daly City, CA 94015
  64.  
  65.                         RBBS: 415-994-2944
  66.                         Compuserve: 70007,1212
  67.  
  68.         FBR is distributed by me for your personal use. You may not
  69.         charge for distributing FBR. Commercial use of FBR is
  70.         prohibited. Corporations and institutions may not use FBR
  71.         without first obtaining written permission. Sorry about that,
  72.         but if anyone is going to make a buck from this, it should be me.
  73.  
  74.  
  75.         Please let me know of any problems, criticisms, or suggestions.
  76.         Thank you.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83. FBR - File Backup/Restore                                            Contents
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.                                 Table of Contents
  92.                                 -----------------
  93.  
  94.                 Introduction ............................... 1
  95.  
  96.                 FB - File backup ........................... 2
  97.  
  98.                   Backup examples .......................... 3
  99.  
  100.                 FR - File restore .......................... 4
  101.  
  102.                 FS - FIle status ........................... 5
  103.  
  104.                 Operational notes .......................... 6
  105.  
  106.                 Version history ............................ 7
  107.  
  108.  
  109.  
  110.  
  111. FBR - File Backup / Restore                                             Page 1
  112.  
  113.  
  114.  
  115.  
  116.                             Introduction
  117.                             ------------
  118.  
  119.         FBR is a system of three small programs which perform
  120.         the backing up and restoring of files. They are similar
  121.         to the DOS BACKUP/RESTORE utilities except that FBR can
  122.         currently only process one directory at a time. It does,
  123.         however, back up all files in a directory, filling as many
  124.         backup disks as necessary. The FBR backup and restore
  125.         programs can select files based upon 30 file specifications.
  126.  
  127.  
  128.  
  129.                              Programs
  130.                              --------
  131.  
  132.         The FBR system consists of these files:
  133.  
  134.             FB.COM   -  used to back up files
  135.             FR.COM   -  used to restore FBR files
  136.             FS.COM   -  to report on contents of FBR files
  137.             FBR.DOC  -  this document
  138.  
  139.         It is recommended that the FR.COM program be copied to the
  140.         first diskette of each backup. This will insure that the
  141.         restore program is the correct one for restoring the files.
  142.  
  143.  
  144. FBR - File Backup / Restore                                             Page 2
  145.  
  146.  
  147.                         Backup - FB Command
  148.                         -------------------
  149.  
  150.         To back up files in a directory, use the FB.COM program.
  151.  
  152.  
  153.     FB  [d:][\path][filespec] [filespec...] [/D] [/M] [/2] [/C] [/V] [t:]
  154.  
  155.  
  156.         If no command line parameters are supplied, FB backs up
  157.         all the files in the current directory to the disk in
  158.         drive A.
  159.  
  160.         If the first d: operand is supplied, it specifies the drive,
  161.         and/or path, and/or a file specification for the files to
  162.         be backed up. Only files matching the 'filespec' are
  163.         processed.
  164.  
  165.         More than one 'filespec' may be supplied. Separate each
  166.         file specification by a blank or a comma.
  167.  
  168. |       The IBMDOS.COM, IBMBIO.COM, MSDOS.SYS, and IO.SYS files are
  169. |       ignored.
  170.  
  171.         The last 't:' operand specifies the target drive, and it must
  172.         be the LAST operand.
  173.  
  174. |       The /D operand specifies that all files on the target
  175. |       disk be deleted before files are backed up to it.
  176.  
  177.         The /M operand specifies that only modified files are
  178.         to be backed up, i.e. archive bit not set.
  179.  
  180.         The /2 operand specifies that the target drive is to
  181.         alternate from either B to A, or from A to B. This allows
  182.         backups to continue while changing floppy diskettes.
  183.  
  184.         The /C operand specifies that the archive bit for each
  185.         file copied should be reset.
  186.  
  187.         The /V operand specifies that the DOS verify function should
  188.         be used. This results in slower I/O but perhaps more peace
  189.         of mind.
  190.  
  191.         As each file is processed, a message is displayed telling
  192.         you the name of the file that has been copied. You may abort
  193.         the back-up by pressing ESCape or control-C.
  194.  
  195.         When a backup drive fills, you are asked to ready another
  196.         diskette and to press any key. To cancel the backup at this
  197.         point, press the ESCape key. The state of the copied files
  198.         is unpredictable if you cancel the back up.
  199.  
  200.  
  201. FBR - File Backup / Restore                                             Page 3
  202.  
  203.  
  204.  
  205.         Backup Examples:
  206.         ---------------
  207.  
  208.         o  If the current drive is C: and the current directory
  209.            is \ME, then to backup all of the C:\ME files
  210.            onto two alternating drives, issue the following:
  211.  
  212. |               FB /2    -or-  FB C:\ME\*.* /2  B:
  213.  
  214.         o  To backup only files with an extension of COM or EXE:
  215.  
  216.                 FB *.COM *.EXE
  217.  
  218.  
  219. FBR - File Backup / Restore                                             Page 4
  220.  
  221.  
  222.                             Restore - FR Command
  223.                             --------------------
  224.  
  225.         To restore files backed up by FB, use the FR.COM program.
  226.  
  227.                 FR  [d:][\path]  [filespec...]  [/2]
  228.  
  229.         The 'd:' operand specifies the drive which contains the
  230.         FBR files from FB. If omitted, drive A is used.
  231.  
  232. |       The \path operand identifies the FBR file to use for the
  233. |       restore. If omitted, the first FBR file found is used.
  234.  
  235.         Up to 30 "filespec" parameters may be supplied. Only those
  236.         files which match one of the "filespecs" are restored.
  237.  
  238.         The '/2' operand specifies that two drives are to be used
  239.         for restoring files. The request for readying drives
  240.         alternates from B to A, or from A to B.
  241.  
  242.         If you mount the wrong FBR disk, the program aborts. This
  243.         will be corrected in a later version.
  244.  
  245.         As each file is restored, a message is displayed telling
  246.         you the name of the file. As a backup disk becomes
  247.         completely read, you are asked to ready another. You
  248.         may press the ESCape or control-C at any time to cancel
  249.         the restore operation. All files except the last one are valid.
  250.  
  251.         If the target disk runs out of space, the restore stops and
  252.         the last file may be unusable.
  253.  
  254.         Each restored file has the same date and file attribute
  255. |       as the original file. Existing files are over-written.
  256.  
  257.  
  258.         Examples:
  259.         ---------
  260.  
  261.         o  To restore the files from an FBR disk(s) in
  262.            drive B, use the following:
  263.  
  264.                 FR B:
  265.  
  266.         o  Restore the subdirectory TEST which has an FBR file
  267.            name of @TEST@@@.#01
  268.  
  269.                 FR a:\test
  270.  
  271.         o  To restore only files with an extension of COM or EXE:
  272.  
  273.                 FR *.COM *.EXE
  274.  
  275.  
  276.  
  277. FBR - File Backup / Restore                                             Page 5
  278.  
  279.                             Status - FS Command
  280.                             -------------------
  281.  
  282.         To determine the names of files backed up into FBR file(s),
  283.         and on which diskette they reside, use the FS.COM program.
  284.  
  285.                 FS  [d:][pathname]  [/N]
  286.  
  287.         The single operand 'd:' specifies the drive which contains
  288.         the FBR file(s). If omitted, drive A is assumed.
  289.  
  290.         If no 'pathname' is supplied, the directories for all FBR
  291.         files on the disk are displayed. Otherwise, only those
  292.         FBR files which match the pathname are shown.
  293.  
  294.         It is not necessary to use the first disk of FBR files for
  295.         FS to display file status information. The LAST diskette
  296.         contains the most accurate data regarding which diskettes
  297. |       that files are on. If the 'Position' is given as '?', the
  298. |       diskette numbers are estimates.
  299.  
  300.         For each file backed up by FB, one line of information is
  301.         displayed. This includes the file name, create date, file
  302.         size, file attributes, and the diskette number. The files
  303.         are displayed in alphabetical order unless the /N option
  304. |       is used, then the files are listed in the physical order
  305. |       in which they were backed up.
  306.  
  307.         If a file starts on one disk and ends on another, two volume
  308.         numbers are displayed, e.g. 01 02.
  309.  
  310.         When the screen fills, the message "more..." is displayed.
  311.         You may enter ESCape or control-C, or the letter N to abort
  312.         and return to DOS.
  313.  
  314.  
  315. FBR - File Backup / Restore                                             Page 6
  316.  
  317.  
  318.                               Operational Notes
  319.                               -----------------
  320.  
  321.         The FB backup program creates one file on each disk that it uses.
  322.  
  323.         The filename is of the form '@ppppppp.#nn',
  324.  
  325.              where 'nn' is a sequential volume number beginning with 01;
  326.              and 'ppppppp' is the name of the origin directory. For root
  327.              directories, the name also contains the drive letter.
  328.              For example, '@ROOTC@@.#01' is the first backup file for
  329.              the root directory of the disk from drive C.
  330.  
  331. |       FB  may not scratch the target disk. It will use whatever space
  332.         is available for making its backup copies and ask for another
  333.         disk as needed. Because the FBR filenames are taken from the
  334.         the origin directory name, more than directory may be backed up
  335.         onto one diskette.
  336.  
  337.         FB requires about 64K of memory but will use all available
  338.         memory if it needs to for storing directory information.
  339.  
  340.         FR restores files to the current drive and subdirectory. This
  341.         is intentional as it yields more flexibility.
  342.  
  343.         I've noticed that FBR is about twice as fast as BACKUP, and
  344.         that the /2 option for using two drives is very helpful. The
  345.         amount of disk space is about the same.
  346.  
  347.         The FBR files may reside on any type of disk supported by the
  348.         operating system. That is, a floppy diskette may be backed up
  349.         to a fixed disk, if so desired.
  350.  
  351.         Since the FBR files are unique on any disk (or subdirectory)
  352.         there is no reason why they can not be sQueezed or ARCed for
  353.         transporting to other systems. For example, an entire floppy
  354.         disk of files will most likely produce one FBR file that can
  355.         be compressed and then transmitted.
  356.  
  357.  
  358.                              More?
  359.                              -----
  360.  
  361.         FBR was written to satisfy my personal method of backup. I'm
  362.         sure there are much better methods and programs, but FBR is
  363.         cheap (free), and it's easy for me to use. I don't use it for
  364.         all my backup procedures.
  365.  
  366.         Future enhancements will allow processing all subdirectories
  367.         in the current directory, formatting of the target disks, and
  368.         the ability to add files to an existing FBR file.
  369.  
  370.         If you like FBR, let me know. Otherwise I'll get bored with
  371.         it and forget all about it.
  372.  
  373.  
  374. FBR - File Backup / Restore                                             Page 7
  375.  
  376.  
  377.  
  378.                              Version History
  379.                              ---------------
  380.  
  381.         1.0 - October 28, 1985
  382.  
  383.         1.1 - October 30, 1985
  384.                 - added /C and /V options to FB
  385.                 - subdirectory and IBMxxx.COM entries are excluded
  386.                   from the FBR files to save some space
  387.                 - fixed the ESCape (or ctrl-C) response to abort FB
  388.                 - changed FS to show two disk numbers for files which
  389.                   span volumes
  390.  
  391.         1.2 - October 31, 1985
  392.  
  393.         1.3 - November 12, 1985
  394.                 - the table at the beginning of each FBR file now contains
  395.                   the actual diskette number for each file, this makes
  396.                   this version incompatibile with previous versions, so
  397.                   it's a good idea to place FR.COM on each FBR disk.
  398.                 - FS now lists the file alphabetically, and if the last
  399.                   disk is used, the diskette numbers are accurate; otherwise
  400.                   the diskette number is calculated and may not be correct.
  401.                 - the FBR file name was changed to allow multiple directories
  402.                   to be backed up onto one disk; this also provides more
  403.                   information about what the FBR file contains.
  404.                 - the ESCape key can be used at any time during FB to abort
  405.                   the backup.
  406.  
  407.         1.4 - December 7, 1985
  408.                 - FB may selectively back up files
  409.                 - FR may selectively restore files
  410.                 - FS processes all FBR files on the specified drive
  411.                 - the ESCape and control-C keys may be used at any
  412.                   time to abort an FBR program; control-break is not
  413.                   accepted
  414.  
  415.         1.45 - January 25, 1986
  416.                 - correct path syntax for FR
  417.  
  418.         1.47 - February 2, 1986
  419.                 - corrections to FR for multiple volumes
  420.  
  421.         1.49 - February 16, 1986
  422.                 - corrections to FR for large files spanning two disks
  423.                 - add path operand to FS
  424.                 - remove BIOS specific display routines from FS
  425.  
  426.         1.50 - March 13, 1986
  427.                 - corrections to FR for selective file restore
  428.                 - add display options to FS
  429.  
  430. |       1.53 - May 21, 1986
  431. |               - add /D option to FB to delete files on target disks
  432. |               - exclude MSDOS.SYS and IO.SYS
  433. |               - change FB to process files in ascending size order
  434.  
  435.